draftjs_html 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 007b3fd847f3459f78a1a8d93b04f7483a30b885aef9413ade39f60de7e93651
-  data.tar.gz: b6a44a4f153ff355937e362474e2700b216101a06f610a772a8230908ac7598e
+  metadata.gz: 46528a3d1be673050e64b56e4040d8c417b2f58932da8a53578f07fc7a21bf40
+  data.tar.gz: 541d38609ec3193c31276376f4ed59b6738cc0602450e14968a911a8be8e52ab
 SHA512:
-  metadata.gz: 34b4e47439bbdb80e0a033ea98ebfab2ebfae8cce677df6c8b3e60f5e924fe470c289b7f56f23067087f449443a0047dbdea243190d865786232d11d05df8e29
-  data.tar.gz: d3e28487c9700f2beacbb092ead7391e8f7e7e680531cc343978f8b3b0fe7c302a5d07c87ea981da01b84d51bac210b151b561c5f4330e934aabbf719be0c659
+  metadata.gz: d1836e450c66f111355bad3a575249f6163d9aa9c7a779df4c30cfb06b8cb7ab36501dec1839866d587f0ef1cac4f0006c1cbd098ac57277e6433bb1b137da79
+  data.tar.gz: a2514f4841316b7bd552b1ddf26fd7380a039f7772741699f70de96bcbb2df07eb9bfd1db866162baa52f291a5fd5d0b78968f4ab2e7da9251605f26a57a6e2d

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 2.7.0
+  - 2.7.5
+  - 3.0.0 
+  - 3.1.2 

data/README.md

@@ -1,5 +1,8 @@
 # DraftjsHtml
 
+[![Gem Version](https://badge.fury.io/rb/draftjs_html.svg)](https://badge.fury.io/rb/draftjs_html)
+[![Build Status](https://app.travis-ci.com/dugancathal/draftjs_html.svg?branch=main)](https://app.travis-ci.com/dugancathal/draftjs_html)
+
 This gem provides conversion utilities between "raw" [DraftJS] JSON and HTML.
 My team and I have found a need on many occasions to manipulate and convert
 DraftJS on our Ruby backend - this library is the result.
@@ -54,19 +57,84 @@ raw_draftjs = {
   },
 }
 
-DraftjsHtml.to_html(raw_draftjs, {
+DraftjsHtml.to_html(raw_draftjs, options: {
   entity_style_mappings:  {
-    link: ->(entity, content) {
-      %Q{<a href="#{entity.data['url']}">#{content}</a>}
+    abc: ->(entity, content) {
+      %Q{<a href="https://example.com/?id=#{entity.data['user_id']}">#{content}</a>}
     },
   },
-}) # => <p>Hello </p>
+}) # => <p>Hello <a href="https://example.com/?id=123">@Arya</a></p>
 ```
 
 Almost all of the options support Procs (or otherwise `.call`-ables) to provide
 flexibility in the conversion process. As the library uses Nokogiri to generate
 HTML, it's also possible to return `Nokogiri::Node` objects or String objects.
 
+### ToHtml Options
+
+#### `:encoding`
+
+Specify the HTML generation encoding.
+Defaults to `UTF-8`.
+
+#### `:entity_style_mappings`
+
+Allows the author to specify special mapping functions for entities.
+By default, we render `LINK` and `IMAGE` entities using the standard `<a>` and `<img>` tags, respectively.
+The author may supply a Proc object that returns any object Nokogiri can consume for adding to HTML.
+This includes `String`, `Nokogiri::Document::Fragment`, and `Nokogiri::Document` objects.
+
+#### `:block_type_mapping`
+
+You may wish to override the default HTML tags used for DraftJS block types.
+By default, we convert block types to tags as defined by `DraftjsHtml::ToHtml::BLOCK_TYPE_TO_HTML`.
+These may be overridden and appended to, like so:
+
+```ruby
+DraftjsHtml.to_html(raw_draftjs, options: {
+  block_type_mapping: {
+    'unstyled' => 'span',
+  },
+})
+
+# This would generate <span> tags instead of <p> tags for "unstyled" DraftJS blocks.
+```
+
+#### `:inline_style_mapping`
+
+You may wish to override the default HTML tags used to render DraftJS `inlineStyleRanges`.
+This works very similarly to `:block_type_mapping`, and the tags are defined by `DraftjsHtml::ToHtml::STYLE_MAP`.
+These may be overridden and appended to, like so:
+
+```ruby
+DraftjsHtml.to_html(raw_draftjs, options: {
+  inline_style_mapping: {
+    'BOLD' => 'strong',
+  },
+})
+
+# This would generate <strong> tags instead of <b> tags around ranges of `BOLD` inline styles.
+```
+
+#### `:inline_style_renderer`
+
+If the direct mapping from `:inline_style_mapping` isn't enough, you can supply a custom function for rendering a style range.
+This function, when provided, will be called with all applicable styles for a range, and the relevant content/text for that range.
+It bears stressing that this `#call`-able will be called with *all* defined styles for the content/character range.
+This means that by declaring this function, you take responsibility for handling _all_ styles for that range.
+However, if you "return" `nil` (or `false-y`) from the proc, it will fallback to the standard "mapping" fucntionality.
+
+```ruby
+DraftjsHtml.to_html(raw_draftjs, options: {
+  inline_style_renderer: ->(style_names, content) {
+    next if style_names != ['CUSTOM']
+    "<pre>#{content}</pre>"
+  },
+})
+
+# This would use the default inline style rendering UNLESS the *only* applied style for this range was "CUSTOM"
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run

data/lib/draftjs_html/draftjs/block.rb

@@ -17,6 +17,10 @@ module DraftjsHtml
         text.length
       end
 
+      def blank?
+        text.empty? && entity_ranges.empty?
+      end
+
       def each_char
         return to_enum(:each_char) unless block_given?
 

data/lib/draftjs_html/to_html.rb

@@ -53,8 +53,8 @@ module DraftjsHtml
     }.freeze
 
     def initialize(options)
-      @document = Nokogiri::HTML::Builder.new
       @options = ensure_options!(options)
+      @document = Nokogiri::HTML::Builder.new(encoding: @options.fetch(:encoding, 'UTF-8'))
     end
 
     def convert(raw_draftjs)
@@ -107,6 +107,8 @@ module DraftjsHtml
     end
 
     def block_element_for(block)
+      return 'br' if block.blank?
+
       @options[:block_type_mapping].fetch(block.type)
     end
 

data/lib/draftjs_html/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DraftjsHtml
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: draftjs_html
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - TJ Taylor
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-09-30 00:00:00.000000000 Z
+date: 2022-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -47,6 +47,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".travis.yml"
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt