راهنمای استایل (ظاهر)
این بخش رسمی آموزش استایل کدنویسی و استانداردهای مخصوص یک پروژه vue است. اگر از vue در پروژه‌ای استفاده می‌کنید این بهترین منبع برای دور شدن از خطاها، بحث‌های بی‌مورد و ضد الگوهاست. با این‌حال ما فکر نمی‌کنیم هیچ راهنمای استایلی برای تمامی تیم‌ها و پروژه‌ها ایده‌آل باشد. تجربه نشان می‌دهد الگوهای ذهنی را میزان فناوری در اطراف و ارزش‌های ذهنی مشخص می‌کنند.
در بیشتر موارد، ما همچنین از پیشنهادات در مورد جاوااسکریپت یا به طور کلی HTML اجتناب می‌کنیم. برای ما حائز اهمیت نیست اگر نقطه ویرگول یا کاماهای انتهایی استفاده می‌کنید. ما اهمیتی نمی‌دهیم که در HTML شما برای استرینگ‌ها از نقل قول‌های تک یا دو نقل قول (double quotation or single quotation) استفاده می‌کنید. با این حال، برخی استثناها وجود دارد، مثلا ما دریافتیم که داشتن یک الگوی خاص در زمینه Vue مفید است.
در نهایت، قوانین به چهار دسته تقسیم می‌شوند:
دسته‌بندی‌های قوانین
اولویت‌های A: ضروری‌‌ها (پیشگیری از خطا)
این قوانین به جلوگیری از خطاها کمک می‌کنند، بنابراین آنها را یاد بگیرید و به هر قیمتی از آنها استفاده کنید. ممکن است استثنائاتی وجود داشته باشد، اما بسیار کمیاب هستند و فقط توسط افرادی که در جاوااسکریپت و Vue دانش تخصصی دارند، ممکن است ایجاد شوند.
اولویت‌های B: به شدت توصیه می‌شود.
این قوانین برای بهبود خوانایی و/یا تجربه توسعه دهنده در اکثر پروژه ها یافت شده است. اگر آنها را نقض کنید، کد شما همچنان اجرا می شود، اما نقض‌ها باید کم باشند و به خوبی توجیه شوند.
الویت‌های C: توصیه می‌شوند.
در جایی که گزینه‌های متعدد و به همه به یک اندازه خوب وجود دارد، می توان یک انتخاب دلخواه برای اطمینان از ثبات انجام داد. در این قوانین، هر یک از گزینه‌های قابل قبول را شرح می‌دهیم و یک انتخاب پیش فرض را پیشنهاد می‌کنیم. این بدان معناست که می‌توانید با خیال راحت انتخاب متفاوتی در پایگاه کد خود داشته باشید، به شرطی که بدون تغییر باشد و دلیل خوبی داشته باشید. لطفاً دلیل خوبی داشته باشید! با انطباق با استاندارد جامعه، شما:
- مغز خود را آموزش دهید تا به راحتی بیشتر کدهای کامیونیتی را که با آن روبرو می شوید تجزیه کند
- بتوانید اکثر نمونه های کد کامیونیتی را بدون تغییر کپی و پیست کنید
- غالباً می‌بینید کارمندان جدید استخدام شده، دست کم در مورد Vue، از قبل به سبک کدنویسی مورد علاقه شما عادت کرده‌اند.
الویت‌های D: با احتیاط از آنها استفاده کنید
برخی از ویژگی‌های Vue برای حالات نادر یا مهاجرت‌‌های نرم‌تر از یک پایگاه کدهای قدیمی وجود دارد. با این حال، وقتی بیش از حد از این ویژگی‌ها استفاده می‌شود، می‌توانند حفظ کد شما را دشوارتر کنند یا حتی به منبع باگ‌ها تبدیل شوند. این قوانین به ویژگی‌های بالقوه پرخطر اشاره می‌کنند و توضیح می‌دهند که چه زمانی و چرا باید از آنها اجتناب کرد.