Rails タグ投稿機能のコード解説

モデル作成

$ rails g model Tag tag_name:string                     //Tagモデル作成
　
$ rails g model TagMap post:references tag:references  //TagMapモデル作成

投稿画面

posts/new.html.erb

<%=form_with(model: @post, url: posts_path, local: true) do |f| %>
             <h1>投稿する</h1>
             <%= f.text_field :tag_name%>・・１
             <input type="submit" value="投稿">
<% end %>

コードの解説

１・・<%= f.text_field :tag_name：この行を記述することで、フォームに入力されたタグが、params[:post][:tag_name]というパラメータとしてcreateアクションへ送信される。

コントローラの作成

posts_controller.rb

def create
    @post = Post.new(
      content: params[:content],

      user_id: @current_user.id
    )
     tag_list = params[:post][:tag_name].split(nil)・・１
    if image = params[:post][:image]
      @post.image.attach(image)
    end
    if @post.save
       @post.save_tag(tag_list)・・２
       flash[:notice] = '投稿を作成しました'
       redirect_to('/posts/index')
    else
      render('posts/new')
    end
  end

コードの解説

１・・params[:post][:tag_name]はformから、@postオブジェクトを参照してタグの名前も一緒に送信するのでこの形で取得する。次にsplit(nil)で送信されてきた値を、スペースで区切って配列化する。配列化する理由はあとでこの値をデータベースに保存する際に一つずつ繰り返し処理で取り出す必要があるため。
２・・先ほど取得したタグの配列をデータベースに保存する処理をモデルファイルで行うようにする。
タグで入力した値を配列に収めてる（tag_list)を引数としてモデルファイルに渡す。

Tag_mapモデルファイルの作成

models/tag_map.rb

class TagMap < ApplicationRecord
  belongs_to :post・・１
  belongs_to :tag・・１
  validates :post_id, presence: true・・２
  validates :tag_id, presence: true・・２
end

コードの解説

１・・複数のPost、複数のTagに所有されるのでbelongs_toで関連付けを行う。
２・・PostとTagの関係を構築する際、2つの外部キーが存在しなければならないのでvalidatesの記述を書きます。

Tagモデルファイルの作成

models/tag.rb

class Tag < ApplicationRecord
  has_many :tag_maps, dependent: :destroy, foreign_key: 'tag_id'
  has_many :posts, through: :tag_maps
end

コードの解説

tag_mapsテーブルとの関連付けを行ってから、tag_mapsを通してpostsテーブルと関連づけています。Tag.postsとすれば、タグに紐付けられたPostを取得できる。

Postモデルファイルの作成

models/post.rb

class Post < ApplicationRecord
 　　has_many :tag_maps, dependent: :destroy
  has_many :tags, through: :tag_maps
 

  def save_tag(sent_tags)
    current_tags = tags.pluck(:tag_name) unless tags.nil?・・１
    old_tags = current_tags - sent_tags・・２
    new_tags = sent_tags - current_tags・・３

    old_tags.each do |old|
      tags.delete Tag.find_by(tag_name: old)・・４
    end

    new_tags.each do |new|
      new_post_tag = Tag.find_or_create_by(tag_name: new)・・５
      tags << new_post_tag・・5
    end
  end
end

コードの解説

１・・先ほどcreateアクションにて保存した@postに紐付いているタグが存在する場合、タグの名前を配列として全て取得する。
２・・現在取得した@postに存在するタグから、送信されてきたタグを除いたタグをold_tagsとする。
３・・送信されてきたタグから、現在存在するタグを除いたタグをnew_tagsとする。
４・・古いタグを削除する。
５・・新しいタグの保存（tagsにpost_tagを追加して保存）

参考記事

【Rails】gemなしで投稿に対してタグ付けする機能＋タグで投稿を絞り込み表示する機能の実装手順
[Ruby on rails]タグ付け機能① 複数のタグ付け
railsのself.tags << post_tagの意味