نسخهٔ ۵ React Simple Maps منتشر شد
خلاصهٔ کاملتر
React Simple Maps یه کتابخونهٔ ریاکته برای ساختن نقشههای SVG برای مصورسازی داده، و نسخهٔ ۵ش منتشر شده. ایدهٔ اصلیش اینه که به جای کانفیگکردن یه چارت لایبرری بزرگ، نقشه رو از چندتا کامپوننت کوچیک خودت میچینی؛ دقیقاً مثل وقتی که یه لایوت وب معمولی مینویسی. زیر کاپوت روی d3-geo (همون بخش d3 که تصویرسازی جغرافیایی رو انجام میده) و topojson سواره.
سه کامپوننت هستهش اینان: ComposableMap که قاب نقشه و projection رو میسازه، Geographies که فایل جغرافیایی رو میگیره و شکلها رو تحویل میده، و Geography که هر مرز یا ناحیه رو رسم میکنه.
<ComposableMap projection="geoAlbersUsa">
<Geographies geography={geoUrl}>
{({ geographies }) => geographies.map(geo => (
<Geography key={geo.rsmKey} geography={geo} fill="#0066FF" />
))}
</Geographies>
</ComposableMap>تو سایتش اومده که هر چیزی که مختصات داشته باشه قابل نقشهکردنه: مرز کشورها، خطوط ایالتی، رودخونهها یا پوشش زمین. کافیه فایل GeoJSON یا TopoJSON خودت رو بدی بهش، یعنی به یه دیتاست از پیش تعیینشده گیر نمیکنی و نصبش هم یه npm install react-simple-maps سادهست.
تیمش تأکید میکنه که پروژه نزدیک ده ساله سرپاست و API هستهٔ کار تو این مدت تقریباً دستنخورده مونده. عددهاش هم اینان: ۳۳۰۶ ستاره روی گیتهاب از ۲۰۱۸، لایسنس MIT، هفتهای بیش از ۹۰۰ هزار دانلود و حجم کامل gzipشده ۳۴.۳ کیلوبایت با احتساب d3-geo.
نکات کلیدی:
- نسخهٔ ۵ منتشر شد؛ کاملاً تایپشده و با بالای ۹۰ درصد پوشش تست.
- سه کامپوننت هسته: ComposableMap، Geographies و Geography، ساختهشده روی d3-geo و topojson.
- هر فایل GeoJSON یا TopoJSON خودت رو میتونی بدی، به دیتاست خاصی وابسته نیست.
- حجم کامل gzipشده ۳۴.۳ کیلوبایت با احتساب d3-geo، و هفتهای بیش از ۹۰۰ هزار دانلود.
- لایسنس MIT و ۳۳۰۶ ستاره روی گیتهاب از سال ۲۰۱۸.




