افزودن فیلدهای فرم تعاملی

طبق بخش 12.7 استاندارد ISO 32000-1، یک فرم تعاملی در سطح ریشه سند درون واژه‌نامه کاتالوگ زیر کلید /AcroForm نگهداری می‌شود. واژه‌نامه /AcroForm به‌عنوان کنترل‌کننده اصلی همه فیلدهای تعاملی در کل سند عمل می‌کند و ویژگی‌های سراسری مانند موارد زیر را تعریف می‌کند:

1. /Fields: آرایه‌ای از ارجاع‌های غیرمستقیم که به واژه‌نامه‌های فیلد پایانی و غیرپایانی ریشه اشاره می‌کنند.

2. /DR (منابع پیش‌فرض): یک واژه‌نامه منابع شامل ارجاع‌های فونت (مانند /Helv برای Helvetica استاندارد یا ZapfDingbats برای تیک‌ها) و فضاهای رنگی لازم برای رندر پویای مقادیر فیلد.

3. /DA (ظاهر پیش‌فرض): رشته‌ای شامل عملگرهای تایپوگرافیک پیش‌فرض (برای مثال '/Helv 12 Tf 0 g') که به موتورهای خواننده می‌گوید متن تازه واردشده را چگونه سبک‌دهی کنند.

4. /NeedAppearances: پرچمی بولی که در صورت نبود جریان‌های ظاهری از پیش کامپایل‌شده، از اپلیکیشن‌های نمایش می‌خواهد جریان‌های ظاهری بصری را در لحظه بسازند.

هر فیلد تعاملی هم‌زمان در صفحه هدف خود به‌صورت یک حاشیه‌نویسی /Widget درون آرایه /Annots صفحه نمایش داده می‌شود. این معماری دوگانه، مدل داده منطقی فیلد فرم را مستقیماً به هندسه بصری فیزیکی آن روی صفحه متصل می‌کند.

استاندارد ISO 32000 از طریق کلید /FT چهار نوع فیلد اصلی تعریف می‌کند که هر کدام از رفتارهای عملیاتی ویژه‌ای پشتیبانی می‌کنند:

1. فیلدهای متنی (/FT /Tx): ورودی‌های تک‌خطی یا چندخطی برای نام‌ها، نشانی‌ها و توضیحات روایی. تنظیم بیت ۱۳ در پرچم‌های فیلد (/Ff 4096) شکست خودکار چندخطی را فعال می‌کند و بیت ۱۴ ‏(/Ff 8192) نویسه‌های واردشده را برای فیلدهای رمز عبور پنهان می‌کند.

2. فیلدهای دکمه (/FT /Btn): شامل دکمه‌های فشاری، چک‌باکس‌ها و گروه‌های دکمه رادیویی با انحصار متقابل. چک‌باکس‌ها میان حالت '/Off' و یک حالت صدور سفارشی (برای مثال '/Yes') جابه‌جا می‌شوند، در حالی که گروه‌های دکمه رادیویی یک نام فیلد والد مشترک دارند که در هر لحظه فقط یک ویجت فرزند می‌تواند فعال باشد.

3. فیلدهای انتخاب (/FT /Ch): شامل جعبه‌های ترکیبی (منوهای کشویی) و جعبه‌های فهرست قابل پیمایش. تنظیم بیت ۱۸ ‏(/Ff 131072) یک منوی کشویی را به جعبه ترکیبی قابل ویرایش تبدیل می‌کند که در آن کاربران علاوه بر انتخاب گزینه‌های از پیش تعریف‌شده (/Opt) می‌توانند ورودی‌های سفارشی تایپ کنند.

4. فیلدهای امضا (/FT /Sig): جایگاه‌های مشخص برای امضاهای دیجیتال رمزنگاری‌شده و مُهرهای زمانی تأیید.

سازنده بصری فرم ما میان تعاملات رابط کاربری مدرن مرورگر و هندسه مختصات سطح پایین PDF پل می‌زند. وقتی یک فیلد متنی یا چک‌باکس را روی بوم پیش‌نمایش سند می‌کشید، رابط کاربری مختصات صفحه‌نمایش را بر حسب پیکسل ثبت و آن‌ها را نسبت به /MediaBox یا /CropBox صفحه به واحدهای کاربری ۷۲ نقطه‌ای PDF تبدیل می‌کند.

موتور نمایشگرهای DPI بالا (window.devicePixelRatio)، مقیاس بزرگ‌نمایی بوم و زاویه‌های چرخش صفحه (0، 90، 180، 270 درجه) را در نظر می‌گیرد. آرایه مستطیل محدودکننده دقیق [xMin yMin xMax yMax] مورد نیاز کلید /Rect فیلد را به‌طور خودکار تولید می‌کند. کادرهای محدودکننده به یک شبکه چیدمان اختیاری می‌چسبند و به سازندگان امکان می‌دهند ستون‌های فرم، ردیف‌های جدولی و خطوط امضا را با دقت میلی‌متری هم‌تراز کنند.

شکایتی رایج از فرم‌های PDF آماتوری، ناوبری نامنظم با Tab است: فشردن کلید Tab باعث می‌شود نشانگر به‌جای حرکت به پایین ستون، به‌طور تصادفی روی صفحه بپرد. طبق معیار موفقیت 2.4.3 در WCAG 2.1 ‏(ترتیب فوکوس)، فرم‌ها باید ترتیب Tab قابل پیش‌بینی و متوالی ارائه دهند.

در معماری PDF، پیمایش Tab با کلید /Tabs در هر واژه‌نامه /Page تعیین می‌شود (/Tabs /S برای ترتیب ساختار، /Tabs /R برای ترتیب ستونی یا ترتیب آرایه در /Annots). سازنده بصری ما به نویسندگان امکان می‌دهد فیلدها را در یک کشوی بصری ترتیب Tab بکشند و دوباره مرتب کنند، آرایه /Fields را خودکار ترتیب‌بندی و /Tabs /A ‏(ترتیب آرایه) را تنظیم می‌کند. کاربرانی که فقط از صفحه‌کلید استفاده می‌کنند و فناوری‌های کمکی صفحه‌خوان می‌توانند به‌روانی و با ترتیب منطقی خواندن از فیلدی به فیلد دیگر بروند.

یکی از بدنام‌ترین نقص‌های ابزارهای آماتوری فرم PDF، تکیه بر پرچم /NeedAppearances بدون تولید جریان‌های ظاهری (/AP) از پیش کامپایل‌شده است. در حالی که Adobe Acrobat رومیزی می‌تواند ظاهر فیلدها را در لحظه بسازد، خواننده‌های مدرن موبایل (Apple iOS Files، ‏Android PDF Viewer) و موتورهای مرورگر تعبیه‌شده (Chrome، ‏Edge، ‏Safari) اغلب /NeedAppearances را نادیده می‌گیرند و نتیجه آن فیلدهای خالی فرم یا جعبه‌های غیرقابل تیک است.

سازنده سمت کاربر ما برای هر فیلد جریان‌های ظاهری عادی کامل (/AP << /N streamRef >>) می‌سازد. برای چک‌باکس‌ها، حالت‌های ظاهری وکتوری را برای هر دو وضعیت تیک‌خورده ('/Yes') و بدون تیک ('/Off') با استفاده از تیک‌های سازگار ZapfDingbats یا مسیرهای وکتوری تیک کامپایل می‌کند. این کار تضمین می‌کند فرم‌های شما در همه پلتفرم‌های سخت‌افزاری و نرم‌افزاری بی‌نقص رندر شوند و به‌صورت تعاملی پاسخ دهند.

طراحی فرم‌های پذیرش سازمانی، الگوهای ثبت‌نام بیمار یا قراردادهای حقوقی اختصاصی اغلب شامل ساختارهای سازمانی حساس، پیش‌نویس بندهای حقوقی و منطق تجاری اختصاصی است. ارسال این الگوهای پیش‌نویس به درگاه‌های ابری تبدیل PDF خطرات قابل اجتناب نشت داده و دردسرهای انطباق با مقررات ایجاد می‌کند.

ابزار «افزودن فیلدهای فرم تعاملی» ما ۱۰۰٪ سمت کاربر درون مرورگر وب شما کار می‌کند. با استفاده از WebAssembly و pdf-lib، فایل PDF پایه تجزیه، درخت‌های واژه‌نامه AcroForm ساخته و جریان‌های باینری مستقیماً در RAM رایانه شما سرهم می‌شوند. اسناد شما هرگز دستگاهتان را ترک نمی‌کنند و محرمانگی کامل سازمانی تضمین می‌شود.